docs/development/Building in Windows light.md

   1 # Building in windows light [Deprecated]
   2 no cygwin and no path changes
   3
   4 ## Install Git for windows
   5 download https://github.com/git-for-windows/git/releases/download/v2.10.1.windows.1/Git-2.10.1-32-bit.exe
   6
   7 Recommended install location is C:\Git (no spaces or special characters in path)
   8
   9 Follow images as not all are at default settings.
  10
  11 ![Git Installation](assets/001.gitwin.png)
  12
  13 ![Git Installation](assets/002.gitwin.png)
  14
  15 ![Git Installation](assets/003.gitwin.png)
  16
  17 ![Git Installation](assets/004.gitwin.png)
  18
  19 ![Git Installation](assets/005.gitwin.png)
  20
  21 ![Git Installation](assets/006.gitwin.png)
  22
  23 ![Git Installation](assets/007.gitwin.png)
  24
  25 ![Git Installation](assets/008.gitwin.png)
  26
  27 ![Git Installation](assets/009.gitwin.png)
  28
  29 ![Git Installation](assets/010.gitwin.png)
  30
  31 ## Install toolset scripts
  32 download https://www.dropbox.com/s/hhlr16h657y4l5u/devtools.zip?dl=0
  33
  34 extract it into C:\ it creates devtools folder
  35
  36 ## Install latest arm toolchain
  37 download https://gcc.gnu.org/mirrors.html
  38
  39 extract it into C:\devtools\gcc-arm-none-eabi-... (folder already there)
  40
  41 ## Install Ruby
  42
  43 Install the latest Ruby version using [Ruby Installer](https://rubyinstaller.org).
  44
  45 ## Test
  46 Run C:\devtools\shF4.cmd
  47
  48 If everything went according the manual you should be in mingw console window. (if not we need to update this manual)
  49
  50 Try command "arm-none-eabi-gcc --version" and output should be like in screenshot. (tab complete works here)
  51
  52 ![Test toolchain](assets/001.test.png)
  53
  54 Note1: Advanced users can edit shF4.cmd for paths if they don't want to use defaults. You might want to change TOOLS_DIR and PATH_DIRS variables.
  55
  56 Note2: You can copy shF4.cmd anywhere you want and run it from there. It will open console window in that folder.
  57
  58 Note3: Included example batch-scripts (make_REVO.bat) that you can use to build target just by double clicking it.
  59
  60 ## Checkout and compile INAV
  61
  62 Head over to the INAV Github page and grab the URL of the GIT Repository: "https://github.com/iNavFlight/inav"
  63
  64 Run shF4.cmd and use the git commandline to checkout the repository:
  65
  66 ```bash
  67 git clone https://github.com/iNavFlight/inav
  68 ```
  69 ![GIT Checkout](assets/011.git_checkout.png)
  70
  71 ![GIT Checkout](assets/002.test.png)
  72
  73 To compile your INAV binaries, enter the INAV directory and build the project using the make command. You can append TARGET=[HARDWARE] if you want to build anything other than the default SPRACINGF3 target:
  74
  75 ```bash
  76 cd inav
  77 make TARGET=SPRACINGF3
  78 ```
  79
  80 ![GIT Checkout](assets/003.test.png)
  81
  82 within few moments you should have your binary ready:
  83
  84 ```bash
  85 (...)
  86 arm-none-eabi-size ./obj/main/inav_SPRACINGF3.elf
  87    text    data     bss     dec     hex filename
  88  127468     916   16932  145316   237a4 ./obj/main/inav_SPRACINGF3.elf
  89 arm-none-eabi-objcopy -O ihex --set-start 0x8000000 obj/main/inav_SPRACINGF3.elf obj/inav_1.2.1_SPRACINGF3.hex
  90 ```
  91
  92 You can use the INAV-Configurator to flash the ```obj/inav_1.2.1_SPRACINGF3.hex``` file.
  93
  94 ## Updating and rebuilding
  95
  96 Navigate to the local inavflight repository and use the following steps to pull the latest changes and rebuild your version of inavflight:
  97
  98 ```bash
  99 cd inav
 100 git reset --hard
 101 git pull
 102 make clean TARGET=SPRACINGF3
 103 make
 104 ```